home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 52 / Mac Magazin and MacEasy Magazine CD - Issue 52.iso / Updates / Stata 5.0 Ado-files / ado.sea / newado / kdensity.hlp < prev    next >
Text File  |  1998-11-22  |  3KB  |  96 lines
  1. .-
  2. help for ^kdensity^                                       (manual:  ^[R] kdensity^)
  3. .-
  4.  
  5. Univariate kernel density estimation
  6. ------------------------------------
  7.  
  8.     ^kdensity^ varname [weight] [^if^ exp] [^in^ range] [^,^ ^noden^sity
  9.             ^nogr^aph ^g^enerate^(^newvarx newvard^) n(^#^) w^idth^(^#^)^
  10.             [ ^bi^weight|^cos^ine|^ep^an|^gau^ss|^par^zen|^rec^tangle|^tri^angle]
  11.             ^nor^mal ^stu^d^(^#^) at(^varx^) s^ymbol^(^...^) c^onnect^(^...^)^
  12.             ^t^itle^(^string^)^ graph_options ]
  13.  
  14.  
  15. ^fweights^ and ^aweights^ are allowed; see help @weights@.
  16.  
  17.  
  18. Description
  19. -----------
  20.  
  21. ^kdensity^ produces kernel density estimates and graphs the result.
  22.  
  23.  
  24. Options
  25. -------
  26.  
  27. ^nodensity^ is included for compatibility with previous versions of Stata; you
  28.     probably do not want to specify it.  ^nodensity^ specifies that the graph
  29.     should not be drawn on a density scale and/or that newvard in the ^gen()^
  30.     option should not be returned on the density scale.  You can convert the
  31.     scale to the density scale (area under the curve to equal 1) using the
  32.     scale factor saved in global macro ^S_4^.
  33.  
  34. ^nograph^ suppresses drawing the graph.  This option is often used in conjunction
  35.     with ^generate()^.
  36.  
  37. ^generate(^newvarx newvard^)^ stores the results of the estimation.  newvard will
  38.     contain the density estimate.  newvarx will contain the points at which
  39.     the density is estimated.
  40.  
  41. ^n(^#^)^ specifies the number of points at which the density estimate is to be
  42.     evaluated.  The default is min(_N,50).
  43.  
  44. ^width(^#^)^ specifies the halfwidth of the kernel, the width of the density
  45.     window around each point.  If ^width()^ is not specified, then the "optimal"
  46.     width is used; see ^[R] kdensity^.  In fact, for multimodal and highly
  47.     skewed densities, the "optimal" is usually too wide and oversmooths the
  48.     density.
  49.  
  50. ^biweight^, ^cosine^, ..., ^triangle^ specify the kernel.  (Actually, ^cosine^
  51.     specifies the cosine trace as there is no such thing as a cosine kernel.)
  52.     By default, ^epan^, meaning the Epanechnikov kernel, is used.
  53.  
  54. ^normal^ requests that a normal density be overlaid on the density estimate for
  55.     comparison.
  56.  
  57. ^stud(^#^)^ specifies that a Student's t distribution with # degrees of freedom be
  58.     overlaid on the density estimate for comparison.
  59.  
  60. ^symbol(^...^)^ is ^graph, twoway^'s ^symbol()^ option for specifying the plotting
  61.     symbol.  The default is ^symbol(o)^; see help @graph@.
  62.  
  63. ^at(^varx^)^ specifies a variable that contains the values at which the density
  64.     should be estimated.  ^at()^ allows you to more easily obtain density
  65.     estimates for different variables or different subsamples of a variable
  66.     and then overlay the estimated densities for comparison.
  67.  
  68. ^symbol(^...^)^ is ^graph, twoway^'s ^symbol()^ option for specifying the plotting
  69.     symbol.  The default is ^symbol(o)^; see help @graph@.
  70.  
  71. ^connect(^...^)^ is ^graph, twoway^'s ^connect()^ option for how points are connected.
  72.     The default is ^connect(l)^; see help @graph@.
  73.  
  74. ^title(^string^)^ is ^graph^'s ^title()^ option for specifying the title.  The default
  75.     is ^title(Kernel Density Estimate)^; see help @graph@.
  76.  
  77. graph_options are any of the other options allowed by ^graph, twoway^; see help
  78.     @graph@.
  79.  
  80.  
  81. Examples
  82. --------
  83.  
  84.     . ^kdensity length, xlabel ylabel^
  85.  
  86.     . ^kdensity length, xlabel ylabel w(20)^
  87.  
  88.     . ^kdensity weight, parzen nogr gen(x2 parzen)^
  89.  
  90.  
  91. Also see
  92. --------
  93.  
  94.  Manual:  ^[R] kdensity^
  95. On-line:  help for @graph@, @hist@
  96.